home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / mpeg_play-2.1 / mpeg_play.man.txt < prev    next >
Text File  |  1995-05-09  |  9KB  |  331 lines
  1.  
  2.  
  3.  
  4. MPEG_PLAY(1)             USER COMMANDS               MPEG_PLAY(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      mpeg_play - plays mpeg-1 encoded bitstreams using X11
  10.  
  11. SYNOPSIS
  12.      mpeg_play [ -nob ] [ -nop ] [ [ -display display_name ] [  -
  13.      quality  [on|off]  ] [ -dither dither_option ] [ -loop ] [ -
  14.      eachstat ] [ -seek offset ] [ -start num ] [ -end num ] [  -
  15.      gamma  gamma_correction_value  ]  [  -framerate  num  ]  [ -
  16.      no_display ] [ -shmem_off ] [ -l_range num ] [ -cr_range num
  17.      ] [ -cb_range num ] [ -quiet ] file_name
  18.  
  19. DESCRIPTION
  20.      mpeg_play decodes and displays mpeg-1 encoded bitstreams  on
  21.      systems  running  X11.  The player will create a new window,
  22.      display the bitstream, and  exit.   Any  error  messages  or
  23.      notices are sent to stderr.
  24.  
  25. OPTIONS
  26.      -nob : causes the player to ignore and  not  display  any  B
  27.           frames.
  28.  
  29.      -nop : causes the player to ignore and  not  display  any  P
  30.           frames.
  31.  
  32.      -display display_name : causes the player to open the window
  33.           on the display _d_i_s_p_l_a_y__n_a_m_e.
  34.  
  35.      -quality [on|off] : forces player to choose  output  quality
  36.           over  speed  when  on,  and  vice versa when off.  When
  37.           quality is on, the player uses a computationally expen-
  38.           sive  IDCT  and also improves playback through improved
  39.           handling of half pixel motion vectors.  The default can
  40.           be  set  to  on  if you compile mpeg_play with the flag
  41.           -DQUALITY.
  42.  
  43.      -dither dither_option : selects from  a  variety  of  dither
  44.           options. The possible values are:
  45.  
  46.           ordered - ordered dither.
  47.  
  48.           ordered2  -  a  faster  ordered  dither.  This  is  the
  49.                default.
  50.  
  51.           mbordered - ordered dithering at the macroblock  level.
  52.                Although  there is a noticeable decrease in dither
  53.                quality, this is the fastest dither available.
  54.  
  55.           fs4 - Floyd-Steinberg dithering  with  4  error  values
  56.                propagated.
  57.  
  58.           fs2 - Floyd-Steinberg dithering  with  2  error  values
  59.                propagated.
  60.  
  61.  
  62.  
  63. Sun Release 4.1    Last change: 21 April 1995                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MPEG_PLAY(1)             USER COMMANDS               MPEG_PLAY(1)
  71.  
  72.  
  73.  
  74.           fs2fast - Fast Floyd-Steinberg dithering with  2  error
  75.                values propagated.
  76.  
  77.           hybrid - Hybrid dithering,  a  combination  of  ordered
  78.                dithering  for  the  luminance  channel and Floyd-
  79.                Steinberg 2 error dithering  for  the  chrominance
  80.                channels.  Errors  are NOT propagated properly and
  81.                are dropped  all  together  every  two  pixels  in
  82.                either direction.
  83.  
  84.           hybrid2 - Hybrid dithering as  above,  but  with  error
  85.                propagation among pixels.
  86.  
  87.           2x2 - A dithering technique using a 2x2 pixel area  for
  88.                each  pixel. The image displayed is 4 times larger
  89.                than the  original  image  encoded.  Random  error
  90.                terms are added to each pixel to break up contours
  91.                and gradients.
  92.  
  93.           gray - Grayscale dithering. The image is dithered  into
  94.                128  grayscales. Chrominance information is thrown
  95.                away.
  96.  
  97.           gray256 - Grayscale dithering. The  image  is  dithered
  98.                into  256  grayscales (requires private colormap).
  99.                Chrominance information is thrown away.
  100.  
  101.           color - Full color display (only available  on  24  bit
  102.                color displays).
  103.  
  104.           color2 - Full color display with increased  size  (only
  105.                available on 24 bit color displays).
  106.  
  107.           none - no dithering is done,  no  image  is  displayed.
  108.                Used to time decoding process.
  109.  
  110.           mono  -  Floyd-Steinberg   dithering   for   monochrome
  111.                displays.
  112.  
  113.           threshold  -  Floyd-simple  dithering  for   monochrome
  114.                displays.
  115.  
  116.           ppm - Write a PPM file for each frame.
  117.  
  118.      -loop : makes the player loop back to  the  beginning  after
  119.           reaching the end.
  120.  
  121.      -owncm : makes the player use a  private  colormap  for  the
  122.           window.
  123.  
  124.      -step : requires the user  to  press  return  for  each  new
  125.           frame.
  126.  
  127.  
  128.  
  129. Sun Release 4.1    Last change: 21 April 1995                   2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MPEG_PLAY(1)             USER COMMANDS               MPEG_PLAY(1)
  137.  
  138.  
  139.  
  140.      -seek offset : before playing the movie, seek to  the  given
  141.           offset  in the file (useful for large movies).  In this
  142.           case -end is redefined to give the number of frames  to
  143.           play,  and  -start  has  no meaning.  The offset should
  144.           point to a Sequence or (closed) GOP  header,  but  data
  145.           will  be  discarded  until  one  is found.  The initial
  146.           sequence header will be parsed before  the  seek.   The
  147.           skipped  sections  must  not  change  the  quantization
  148.           matrices or the results are undefined.
  149.  
  150.      -start num : Waits to start display until this frame  number
  151.           (previous frames are parsed).
  152.  
  153.      -end num : ends display at this frame  number  (except  when
  154.           -seek is used).
  155.  
  156.      -gamma gamma_correction_param  :  specifies  the  amount  of
  157.           gamma  correction.  Default is 0.  Use higher values if
  158.           movie looks dark and hard to see.
  159.  
  160.      -framerate num : sets the framerate of the playback  to  num
  161.           frames  per  second.   A  value of 0 indicates that the
  162.           stream should be  played  as  fast  as  possible.   The
  163.           default  is to play at the rate specified in the stream
  164.           (if possible).  Note this is merely  a  framerate  lim-
  165.           iter, it will not discard frames to meet the rate.
  166.  
  167.      -quiet : suppresses printing of frame numbers, timing infor-
  168.           mation, and most error messages.
  169.  
  170.      -eachstat : causes statistics to  be  displayed  after  each
  171.           frame. Only valid when compiled with -DANALYSIS.
  172.  
  173.      -shmem_off : turns shared memory off.
  174.  
  175.      -l_range num_colors : sets the number of colors assigned  to
  176.           the  luminance component when dithering the image.  The
  177.           product of l_range, cr_range  and  cb_range  should  be
  178.           less than the number of colors on the display.
  179.  
  180.      -cr_range num_colors : sets the number of colors assigned to
  181.           the red component of the chrominance range when dither-
  182.           ing the image.  The product of  l_range,  cr_range  and
  183.           cb_range  should  be  less than the number of colors on
  184.           the display.
  185.  
  186.      -cb_range num_colors : sets the number of colors assigned to
  187.           the  blue component of the chrominance range when dith-
  188.           ering the image.  The product of l_range, cr_range  and
  189.           cb_range  should  be  less than the number of colors on
  190.           the display.
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1    Last change: 21 April 1995                   3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. MPEG_PLAY(1)             USER COMMANDS               MPEG_PLAY(1)
  203.  
  204.  
  205.  
  206.      -no_display : dithers, but does not  display,  usually  used
  207.           for testing and timing purposes.
  208.  
  209. NOTES
  210.      The player expects video streams only. It can handle  multi-
  211.      plexed  MPEG streams (video+audio streams) by discarding the
  212.      audio.
  213.  
  214.      Some streams do not end with the proper  sequence  end  code
  215.      and  will probably generate an "Improper sequence end code."
  216.      error when done playing.
  217.  
  218.      This player can play XING data files.  Be  aware  that  XING
  219.      makes  no use of temporal redundancy or motion vector infor-
  220.      mation. In other words, they do not use any P or B frames in
  221.      their  streams. Instead, XING data is simply a sequence of I
  222.      frames. Since I frames take significantly longer to  decode,
  223.      performance of the player using XING data is not representa-
  224.      tive of the player's ability.
  225.  
  226.      The player does not play MPEG-1 D-frame  streams,  but  they
  227.      are a rarity.
  228.  
  229. VERSION
  230.      This is version 2.1, containing some new features since 2.0,
  231.      and  several  bug fixes.  It is a major change since version
  232.      1.0.
  233.  
  234. BUGS
  235.      The only known bug is that multiple mpeg_plays  cannot  seem
  236.      to  be  run  simultaneously on a multiprocessor SPARC 20 (in
  237.      particular: On a bi-processor Sparc 20 running  Solaris  2.3
  238.      or  2.4, it is not possible to run two concurrent "mpeg_play
  239.      -loop" on the same bitstream.  One  of  the  mpeg_play  dies
  240.      when it loops.  )
  241.  
  242. AUTHORS
  243.      Ketan  Patel   -   University   of   California,   Berkeley,
  244.           kpatel@cs.berkeley.edu
  245.  
  246.      Brian  Smith   -   University   of   California,   Berkeley,
  247.           bsmith@cs.berkeley.edu
  248.  
  249.      Henry  Chi-To  Ma  -  University  of  California,  Berkeley,
  250.           cma@cs.berkeley.edu
  251.  
  252.      Kim  Man  Liu  -   University   of   California,   Berkeley,
  253.           kliu@cs.berkeley.edu
  254.  
  255.      Steve  Smoot   -   University   of   California,   Berkeley,
  256.           smoot@cs.berkeley.edu
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 4.1    Last change: 21 April 1995                   4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. MPEG_PLAY(1)             USER COMMANDS               MPEG_PLAY(1)
  269.  
  270.  
  271.  
  272.      Eugene  Hung   -   University   of   California,   Berkeley,
  273.           eyhung@cs.berkeley.edu
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Sun Release 4.1    Last change: 21 April 1995                   5
  328.  
  329.  
  330.  
  331.